home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / uhren & terminkalender / time / tbc / tbc.doc < prev    next >
Text File  |  1996-04-07  |  27KB  |  581 lines
  1.                                   TBC
  2.  
  3.                            (Title Bar Clock)
  4.                   (also known as Threapwood's Big Clock)
  5.  
  6.                            by David M Hollway
  7.  
  8.                              -= Giftware =-
  9.  
  10.                  Version 2.52 (8:55pm, 12th June 1994)
  11.  
  12.  
  13.                                 Contents
  14.                                 --------
  15.  
  16.                             1)  Introduction
  17.                             2)  Disclaimer
  18.                             3)  Installation
  19.                             4)  User Options
  20.                             5)  Tooltypes
  21.                             6)  Contacting the Author
  22.                             7)  Version History
  23.                                 What's new in 2.5
  24.  
  25.  
  26. 1) Introduction
  27.  
  28.    Earlier this year I downloaded (from Aminet) a program called HFK,
  29.  written by Herbert West. HFK displays a simple clock in the left-hand
  30.  end of the Workbench screen title-bar. Importantly, it uses the correct
  31.  colour scheme (even on Kickstart 3.0), ie the same colours as the Workbench
  32.  menus. I like HFK, because it is fully Kickstart 3.0 compatible, and
  33.  simple.
  34.    However, I had one tiny quibble with HFK. If I wanted to change the
  35.  Workbench preferences, then I had to quit HFK, otherwise IPrefs
  36.  displayed a requester saying "Please close all windows". This really
  37.  annoyed me (because I often change screenmodes, and it was really tedious
  38.  to quit & restart HFK each time). Then I hit upon the solution: I wrote
  39.  a simple AmigaDOS script that would quit HFK and then re-start it after
  40.  a short delay (to give IPrefs time to close & re-open the Workbench
  41.  screen). I left the icon for this script on the Workbench, so all that I
  42.  had to do was double-click the icon just before changing screenmode.
  43.    An elegant solution. Or so I thought.
  44.  
  45.    But then one day I was idly reading the "Libraries" RKM (as one does :-) ),
  46.  and I noticed a section about "notification" requests. So "Hey!" I thought,
  47.  "why don't I write a program that will watch the ENV:Sys directory, and
  48.  then when anything is written to this directory,  close down & restart
  49.  HFK?". So I did. That, too, seemed like an elegant solution at the time.
  50.  But then I started thinking that this was a really kludgy solution (to have
  51.  two programs running), and I decided to write a replacement for HFK.
  52.  
  53.    So here's the replacement: TBC!
  54.  TBC is a great program (IMHO ;-) ) offering the following features:
  55.  
  56.                         o  will automatically hide itself to allow
  57.                            IPrefs to reset the screen
  58.                         o  very low CPU load
  59.                         o  fully WB3.0 compatible & enhanced
  60.                         o  can display time in a variety of
  61.                            formats (24 hour, 12 hour etc)
  62.                         o  colours used for display can be altered
  63.                         o  requires OS 2.04 (v37) and above
  64.                         o  Alarm Clock feature
  65.                            that will, at a configurable time,
  66.                            flash the screen/play a sample/beep/
  67.                            launch a command (optional).
  68.                         o  Fully configurable by means of tooltypes
  69.                            or GUI
  70.                         o  Ability to appear automatically on the
  71.                            active screen
  72.                         o  will optionally chime every n minutes
  73.                         o  can also display current date in choice
  74.                            of formats
  75.                         o  as of v2.5, TBC can warn you if your Amiga's
  76.                            memory is running low
  77.  
  78.   Yes, yes, I know, it's a long feature list for a clock program, but
  79.  I just can't stop adding to this program..
  80.  
  81.  
  82.  
  83. 2) Disclaimer
  84.  
  85.    Just in case there are any Americans reading this:
  86.  
  87.   This program is (C) 1994 David M Hollway.
  88.   I take absolutely no responsibility for any damage or loss resulting
  89.   from the use of this program.
  90.   If TBC causes your computer to explode, wiping out 3/4 of your home
  91.   country, it's not my fault.
  92.   If TBC causes the value of your investment portfolio to plummet, it's
  93.   not my fault.
  94.   If TBC causes your aunt to break out in bright green spots and start
  95.   speaking in tongues, again, it's NOT MY FAULT.
  96.  
  97.   "Amiga", "Kickstart", "Lorraine" and "Marketing" are (C) Commodore-Amiga,
  98.   Inc.
  99.  
  100.   Never trust a dog with orange eyebrows.
  101.  
  102.  
  103.   This program has been tested on the author's A4000-030. under both
  104.   Kickstarts 2.04 (37.175) and 3.0 (39.106), and Workbenches 3.0 & 3.1
  105.   (err.. a registered-developer friend of mine came over and tested it
  106.    under 3.1? ;-) )
  107.  
  108.   It's also been tested on a stock Amiga B2000HD (68000 based),
  109.   and an A1200 with 6MB of RAM. No problems have been found.
  110.   
  111.  
  112.   If it doesn't work on your system, PLEASE let me know! I'm especially
  113.   interested to hear from you if you've tried TBC (successfully or
  114.   otherwise) on a 68000-based Amiga. See the end of this documentation
  115.   for information on contacting me!
  116.  
  117.  
  118.  
  119.  
  120. 3) Installation
  121.  
  122.    Easy. Just copy the "TBC" program (and its icon) to a suitable place on
  123.    your disk. If you want TBC to load automatically when you boot, then
  124.    place it in the "WBstartup" drawer of your "SYS:" partition or disk.
  125.  
  126.    That's it. TBC will now run using the default settings.
  127.    To get the best out of TBC however, you should configure it using
  128.    its tooltypes (see section 5 for more details).
  129.  
  130.  
  131.  
  132. 4) User Options
  133.  
  134.    Click with the left mouse button on the TBC window to bring up the
  135.    "TBC Configuration" window.
  136.  
  137.    Options are:
  138.  
  139.    "Foreground:"        : click on a colour in this box, and the text of the
  140.                           TBC display will be rendered in this colour.
  141.  
  142.    "Background:"        : click on a colour in this box, and the background
  143.                           of the TBC display will be rendered in this
  144.                           colour.
  145.  
  146.    "Use Pens:"          : if this gadget is "ticked", then TBC will use the
  147.                           same colours as the Workbench menus. Under
  148.                           kickstart 2.0x, this means grey-on-black.
  149.                           Under 3.x, the menu colours can be set using
  150.                           the "Palette" preferences editor.
  151.  
  152.    "Time:"              : select an option from this gadget. TBC can display
  153.                           the time in one of four formats:
  154.  
  155.                           "6:34 pm"  - 12 hour clock
  156.                           "6:34:00"  - 12 hour clock with seconds display.
  157.                           "18:34"    - 24 hour clock
  158.                           "18:34:00" - 24 hour clock with seconds display.
  159.  
  160.    "Date:"              : As for "Time:" above, TBC can display the current
  161.                           date in a choice of formats. These are:
  162.  
  163.                           "No Date"  - Don't display the date
  164.                           "25.12.94" - Display date in dd.mm.yy format
  165.                           "12.25.94" - Display date in mm.dd.yy format
  166.  
  167.                           If the date is displayed, then the clock display
  168.                           will, each time it updates, toggle between the
  169.                           current time and the current date.
  170.  
  171.    "Update (seconds)"   : enter a number n in the text box next to this
  172.                           option, and the clock will be updated each time
  173.                           n seconds have elapsed.
  174.  
  175.    "Leap (danger!):"    : If you select this option, then TBC will always
  176.                           appear on the currently active screen.
  177.  
  178.                           *CAUTION*
  179.                           If TBC is displayed on a "non public" screen,
  180.                           and that screen is closed by an application,
  181.                           you MAY WELL crash the Amiga.
  182.                           Always make sure that you close TBC (or de-select
  183.                           this option) before closing the application.
  184.  
  185.                           As an extra safeguard, TBC will not leap onto
  186.                           a screen unless:
  187.  
  188.                              a) The screen is wider than 600 pixels
  189.                                 (this rules out most games)
  190.                              b) The screen has a title.
  191.                                 This is to prevent TBC leaping onto the
  192.                                 screen opened by a screenblanker
  193.                                 program, which would (as soon as you
  194.                                 moved the mouse) crash the screenblanker.
  195.  
  196.                           Programs whose screens TBC will leap on to
  197.                           include:
  198.                                Directory Opus v4.x
  199.                                Final Copy
  200.                                Final Writer
  201.                                PCTask
  202.                                Scribble!
  203.  
  204.                           But sadly not DPaint, because it does naughty
  205.                           things with screen overlays etc, and doesn't have
  206.                           a title (it just prints "DPaint" in its title bar)
  207.                           Additionally, as of version 2.2 of TBC, I've
  208.                           added a small (1 second) delay before TBC "leaps"
  209.                           onto a newly active screen.
  210.                           I can't make this feature totally safe, but if you
  211.                           take care, it's very handy.
  212.                           *CAUTION ENDS*
  213.  
  214.                           If this option is switched off, TBC will appear
  215.                           on the default public screen.
  216.  
  217.    "Alarm Hour:"        : use this slider to set the hour at which the alarm
  218.                           will sound (in 24-hour format, 0 to 23).
  219.  
  220.    "Alarm Min:"         : use this slider to set the minutes at which the
  221.                           alarm will sound, ie 0 to 59.
  222.  
  223.    "Chime each:"        : if you enter a number other than 0 in this box
  224.                           then TBC will "chime" each time the "minutes
  225.                           past the hour" reach a multiple of that number.
  226.                           For example, entering 15 will cause TBC to chime
  227.                           at xx.00, xx.15, xx.30, and xx.45.
  228.  
  229.    "Alarm:"             : This cyclebox determines the current state of
  230.                           the alarm feature.
  231.                           It can have the following settings:
  232.  
  233.                            "No Alarm" - Alarm is OFF.
  234.                            "Flash"    - Alarm is ON, and when alarm-time
  235.                                         is reached, the screen will flash
  236.                                         (and beep/play a sample if you
  237.                                         have Workbench 3.x) repeatedly.
  238.                            "Command"  - Alarm is ON, and when alarm-time
  239.                                         is reached, a command or AmigaDOS
  240.                                         script (see "Command:" below) will
  241.                                         be launched.
  242.                            "Do Both"  - The above two options combined.
  243.  
  244.                           Once the alarm is sounding, it can be stopped
  245.                           by clicking with the left mouse button on the
  246.                           TBC display. If the options screen is being
  247.                           displayed when the alarm goes off, you can stop
  248.                           the alarm by setting this cycle-gadget to
  249.                           "No Alarm"
  250.  
  251.    "Command:"           : If you enter a command in this text-box,
  252.                           and set the "alarm" gadget to "Command" or "Do
  253.                           Both", then when TBC sounds its alarm it will
  254.                           also run the command for you. You must give the
  255.                           command's name with its full path, for example:
  256.                            SYS:Utilities/Clock
  257.                                - will run the standard WB clock (why??)
  258.                            SYS:Tools/HDTools/Quarterback
  259.                                - will run a hard-disk backup program
  260.  
  261.                           Note that this can either be a command, or an
  262.                           AmigaDOS script. If the latter, then the script
  263.                           must have its "script" protection bit set, for
  264.                           example type at a shell:
  265.  
  266.                             1.System3.0:> protect mydisk:myscript +S
  267.    "If free mem is less
  268.     than:"              : Type a number into this text box, set the
  269.                           cycle gadget next to it to anything other than
  270.                           "ignore it", and lo! you will be warned by TBC
  271.                           when the amount of free memory (FAST + CHIP)
  272.                           falls below that number of Kilobytes.
  273.                           The options that can be set on the cycle gadget
  274.                           are:
  275.  
  276.                            "ignore it"      - doesn't do anything when memory
  277.                                               is low
  278.                            "flash screen"   - Uses the O/S DisplayBeep()
  279.                                               function to flash the screen
  280.                                               (or play a sample/beep if you're
  281.                                               using 3.0)
  282.                            "show requester" - Displays a Recoverable Alert
  283.                                               when memory is below n K.
  284.                                               An Alert is always a chilling
  285.                                               sight, so I'd recommend that
  286.                                               you:
  287.                                                a) remember not to panic when
  288.                                                   you see it, and
  289.                                                b) use this option if you're
  290.                                                   expecting memory to get
  291.                                                   VERY low (such that
  292.                                                   neither a requester nor a
  293.                                                   beep can be used)
  294.  
  295.    "Use"                : click here to close the options window, and use
  296.                           the current TBC settings.
  297.  
  298.    "Hide"               : click here to hide the TBC window, to allow IPrefs
  299.                           to reset the WB screen. TBC will automagically
  300.                           re-appear after a short delay (see TOOLTYPES).
  301.                           This option is handy if you've changed screenmodes
  302.                           or font, but TBC has re-appeared before IPrefs
  303.                           has been able to reset the WB screen (leading
  304.                           to a "Attempting to close Workbench - Please
  305.                           close all windows except drawers" requester).
  306.  
  307.    "About"              : click here to display some information about the
  308.                           program.
  309.  
  310.    "Quit"               : click here to exit from TBC (why would you want to
  311.                           do this??)
  312.  
  313.  
  314.  
  315. 5) Workbench Tooltypes
  316.  
  317.  By default, TBC displays a 12-hour clock, in the current workbench menu
  318.  colours, updating its display every second.
  319.  
  320.  If you would like the initial options to differ from the defaults, you can
  321.  specify the options by means of TOOLTYPES (if you're not sure how to do
  322.  this, consult a Workbench manual).
  323.  
  324.  TBC supports the following tooltypes:
  325.  
  326.   NONEWLOOK   :  this can be set to either 0 (to use the current WB
  327.                  colours), or 1 (to use the user-defined fixed colour
  328.                  scheme).
  329.  
  330.   DELAY       :  this is the number of seconds that will elapse between
  331.                  successive updates of the TBC display. Sensible values
  332.                  are between 1 and 60. Very silly values are 4000, 99 and
  333.                  "ni".
  334.  
  335.   FOREPEN     :  the pen to use for the writing on the display, ie with
  336.                  the default Workbench 2.x palette, a value of 1 would be
  337.                  black.
  338.  
  339.   BACKPEN     :  the pen to use for the background of the TBC display. Don't
  340.                  set this to the same value as FOREPEN, becauses you won't
  341.                  be able to see the display!
  342.                  *NOTE*: If the NONEWLOOK tooltype is either not specified,
  343.                  or set to 0, then the values of FOREPEN and BACKPEN will
  344.                  be ignored.
  345.  
  346.   FORMAT      :  set this to either 0, 1 or 2, to get one of the following
  347.                  TBC displays:
  348.  
  349.                         0 -  time in format  6:34 pm
  350.                         1 -  time in format  6:34:00
  351.                         2 -  time in format 18:34
  352.                         3 -  time in format 18:34:00
  353.  
  354.   IPREFSWAIT :  Yes, by popular demand here's a tooltype that allows you to
  355.                 set the delay (in seconds) that TBC allows for IPrefs to reset
  356.                 the WB screen. For example, if you specify IPREFWAIT=7, then
  357.                 when the screenmode/font etc of the WB is changed, TBC will
  358.                 hide its window for 7 seconds.
  359.                 A higher value of IPREFSWAIT than the default may be needed
  360.                 if IPrefs has a lot of work to do when resetting the WB,
  361.                 eg closing many drawers, etc.
  362.  
  363.                 ** USERS OF TBC v1.x PLEASE TAKE NOTE **
  364.                 This tooltype is now IPREFS rather than IPREF (note the
  365.                 extra 'S')!
  366.  
  367.   ALARM      :  This determines the initial state of the alarm feature.
  368.                 Valid options are:
  369.  
  370.                         0 - Alarm is OFF.
  371.                         1 - Alarm is ON, and when alarm-time is reached,
  372.                             the screen will flash (and beep/play a sample
  373.                             if you have Workbench 3.x) repeatedly.
  374.                         2 - Alarm is ON, and when alarm-time is reached,
  375.                             a command or AmigaDOS script (set using
  376.                             ALARMRUN) will be launched.
  377.                         3 - 1 & 2 combined.
  378.  
  379.   ALARMHOUR  :  The hour of the alarm, in 24-hour format, eg valid options
  380.                 range from ALARMHOUR=0 to ALARMHOUR=23.
  381.  
  382.   ALARMMIN   :  This tooltype sets the alarm minutes; valid options range
  383.                 from ALARMMIN=0 to ALARMMIN=59.
  384.  
  385.   ALARMRUN   :  This can be used to specify a command to be run when the
  386.                 alarm is activated. For example:
  387.  
  388.                    ALARMRUN=SYS:Prefs/Palette
  389.  
  390.                 For more information, see section 4 (Options).
  391.  
  392.   CHIME      :  This is the chime setting (see section 4)
  393.                 eg: CHIME=15
  394.  
  395.   DATE       :  This is the date format setting, eg:
  396.  
  397.                    DATE=0   means no date is displayed
  398.                    DATE=1   means date is displayed as dd.mm.yy
  399.                    DATE=2   means date is displayed as mm.dd.yy
  400.  
  401.   SCREENLEAP :  Set this option to enable/disable screen leaping.
  402.                 eg: SCREENLEAP=1 or SCREENLEAP=0
  403.  
  404.   MEMWARN    :  This is the amount of memory (in K) below which TBC
  405.                 will alert you..
  406.  
  407.   WARNTYPE   :  ..and this is how TBC will alert you. Valid options are:
  408.  
  409.                   WARNTYPE=0 means "do nothing"
  410.                   WARNTYPE=1 means "flash the screen once"
  411.                   WARNTYPE=2 means "display a requester"
  412.                   WARNTYPE=3 means "display an alert"
  413.  
  414.                 See section (4) "User Options" for more details!
  415.  
  416.  
  417.   In addition you'll need to specify the tooltype DONOTWAIT if you've
  418.   placed TBC in your SYS:WBStartup drawer. If you don't, then you'll see
  419.   a requester saying "TBC has not returned - Shall I wait some more?"
  420.   every time you reboot. This is a real pain in the proverbials, and is
  421.   caused not by TBC but by Kickstart.
  422.  
  423.  
  424.  
  425.  
  426. 6) Contacting the Author
  427.  
  428.    This small trifle has been released as GIFTWARE. This means that if you
  429.  use and like the program, the author (that's me) would welcome a gift from
  430.  you. Please note that this is not compulsory - I hate "Crippleware", so
  431.  I've released this fully working version of TBC (ha! the program has
  432.  hardly any features to begin with.. if I crippled some features the
  433.  program wouldn't do anything :-) ) and I'd love to get a gift from people.
  434.  
  435.  This gift can be *anything* you feel the program is worth.. if nothing else,
  436.  send me some e-mail (address below), a postcard of your home town, or
  437.  even write to me! I'm not expecting anybody to send me a 4000-040, but you
  438.  never know... here's some suggestions for gifts anyway :-)
  439.  
  440.          - a funny/ funky / impressive Sound/Noise/ProTracker module
  441.          - ditto, but in MED/ OctaMED format
  442.          - a humorous anecdote
  443.          - a postcard
  444.          - a letter to say "thank you"
  445.          - an e-mail message
  446.          - vast amounts of money
  447.          - free beer (here's hoping...)
  448.  
  449.  
  450.  If you are Swiss I'd especially like to hear from you, as I'm going to that
  451.  wonderful country for a year (as of July 1994).
  452.  
  453.  I can be contacted in the following ways (in order of preference):
  454.  
  455.  by e-mail: I have two internet addresses, so mail sent to either
  456.  
  457.                dmh11@tower.york.ac.uk
  458.             or dmh-a@minster.york.ac.uk
  459.  
  460.             should reach me.
  461.  
  462.  
  463.  by snail-mail: Bit tricky this one, because of the above mentioned
  464.                 Swiss trip. Probably the best address to send mail to
  465.                 is:
  466.  
  467.  
  468.                      DM Hollway,
  469.                       Langwith College,
  470.                        University of York,
  471.                         Heslington,
  472.                          York,
  473.                           YO1 5DD
  474.  
  475.  by telepathy: Just concentrate «:-)
  476.  
  477.  Anybody interested can get the full source-code for TBC by writing to me,
  478.  and enclosing sufficient money to cover postage from the UK to their
  479.  country (unless they're writing by e-mail of course).
  480.  
  481.  If you find a bug in TBC, *PLEASE LET ME KNOW*! TBC has grown from its
  482.  humble origins to its even more humble present state :-) because of
  483.  feedback from YOU the user!
  484.  
  485.  
  486.  
  487. 7) Version History
  488.  
  489.    Version 0.9:      Initial release.
  490.                      Finally trapped and squashed termination bug (thanks
  491.                      Edd!), and added "time format" option.
  492.                      Made program 2.04+ compatible.
  493.  
  494.    Version 0.91:     Never publicly released.
  495.                      Added 50fps parallax-scrolling shoot-em-up game,
  496.                      featuring 256 colour sprites on AGA machines.
  497.                      "A Classic" said 'Amiga World' magazine.
  498.  
  499.    Version 1.0:      Second release.
  500.                      Removed game (see above).
  501.                      Made clock continue ticking when options window is
  502.                      displayed.
  503.                      Added IPREFWAIT tooltype.
  504.                      Added 24-hour + seconds time-format option.
  505.                      Cleared up a couple of minor bugs (bug-ettes?)
  506.  
  507.    Version 1.1:      Third Release.
  508.                      Considered whether to add game again, but then
  509.                      decided not to embarrass Team-17.
  510.                      Added Alarm-clock option, obtained by means
  511.                      of sliders in options window, and three new
  512.                      tooltypes: ALARMHOUR, ALARMMIN, and ALARM.
  513.  
  514.    Version 1.2:      Never released.
  515.                      Totally re-designed the user interface.
  516.                      Squashed a bug or two (nothing too major).
  517.  
  518.    Version 2.0:      Fourth public release. (8th May 1994)
  519.                      Added "Alarm Run" feature.
  520.                      Cleaned up & optimised code somewhat. It may not
  521.                      be smaller, but it's neater!
  522.  
  523.    Version 2.01:     Never released.
  524.                      Tiny, tiny bug fix.
  525.                      Made BOTH colons "tick" on clock display.
  526.                      Happy, Fergus? :-)
  527.                      Altered user interface layout slightly. (transposed
  528.                      ALARM and UPDATE areas, if you must know)
  529.  
  530.    Version 2.1:      Fifth public release (15th May 1994)
  531.                      Added CHIME, DATE and LEAP options (and tooltypes)
  532.                      Altered user interface layout to accomodate
  533.                      new options.
  534.                      Drastically cleaned up & optimised code, with the
  535.                      result that this new version is only about 500 bytes
  536.                      larger than v2.0, despite the new features.
  537.  
  538.    Version 2.2:      Sixth public release (17th May 1994)
  539.                      Whoops.. there were a couple of fairly major bugs in
  540.                      version 2.1 - occasional screen corruption occurred
  541.                      if the clock used a proportional font. That's now
  542.                      fixed (I hope!). TBC has now been tested with fonts
  543.                      up to 24pt. If you have to use a bigger font than that,
  544.                      then your eyes need seeing to!
  545.                      Improved the ALARM function, so that now you can choose
  546.                      whether to have a beep, run a command, or both when
  547.                      the alarm goes off. (see 'Options' and 'Tooltypes')
  548.                      Replaced RectFill() calls with SetRast(), saving a few
  549.                      bytes. Code should now be bug-free. I bet I'll regret
  550.                      saying that!
  551.  
  552.   Version 2.2.1:     Yes.. I do regret saying that! There was a tiny bug
  553.                      in TBC v2.2 that caused the ALARM tooltype to be
  554.                      ignored. That's now fixed. And I've updated the
  555.                      documentation properly too.
  556.  
  557.   Version 2.5:       Hmm... a couple of silly bugs in previous versions :-(
  558.                      In fact even as I write this I've noticed another bug!
  559.                      Just a moment....   ...there, that's fixed the swine.
  560.                      As I was saying: in this version I've added a "memory
  561.                      warning" feature, and also TBC will now report 12:00am
  562.                      as 12:00 am, whereas in all previous versions it
  563.                      reported it as 0:00am. In addition, previous versions
  564.                      changed from "am" to "pm" at 1:xx, rather than 12:xx.
  565.                      Many thanks to the two people in the U.S who reported
  566.                      those bugs!
  567.  
  568.   Version 2.51:      Well, my beta-testers have failed miserably :-)
  569.                      NOBODY reported the fact that in 2.5 the entire alarm
  570.                      feature didn't work! Many thanks to Slingshot of
  571.                      Dimentia UK who was the only person observant enough
  572.                      to notice this! Duh... It's a good job I didn't release
  573.                      2.5 publicly :-)
  574.  
  575.   Version 2.52:      Well this bug's got me confused.. for some reason, if I
  576.                      set the "seconds" string to _5_ spaces in 24-hour mode,
  577.                      (ie "16:34") then the current hour gets printed instead
  578.                      of the five spaces.. but if I set it to _6_ spaces,  it
  579.                      gets printed as expected! Weird! Anybody out there have
  580.                      an idea why this is the case? Anyway, it's fixed now!
  581.